.TH std::fputws 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::fputws \- std::fputws

.SH Synopsis
   Defined in header <cwchar>
   int fputws( const wchar_t* str, std::FILE* stream );

   Writes every wide character from the null-terminated wide string str to the output
   stream stream, as if by repeatedly executing std::fputwc.

   The terminating null wide character from str is not written.

.SH Parameters

   str    - null-terminated wide string to be written
   stream - output stream

.SH Return value

   On success, returns a non-negative value

   On failure, returns EOF and sets the error indicator (see std::ferror) on stream.

.SH Example


// Run this code

 #include <clocale>
 #include <cstdio>
 #include <cwchar>

 int main()
 {
     std::setlocale(LC_ALL, "en_US.utf8");
     int rc = std::fputws(L"御休みなさい", stdout);

     if (rc == EOF)
         std::perror("fputws()"); // POSIX requires that errno is set
 }

.SH Possible output:

 御休みなさい

.SH See also

   fputs    writes a character string to a file stream
            \fI(function)\fP
   wprintf  prints formatted wide character output to stdout, a file stream or a buffer
   fwprintf \fI(function)\fP
   swprintf
   fputws   writes a wide string to a file stream
            \fI(function)\fP
   fgetws   gets a wide string from a file stream
            \fI(function)\fP
   C documentation for
   fputws
